Skip to content

Reclaim broken backlinks (part 2): 32 more 301 redirects#2821

Merged
ctauchen merged 2 commits into
tigera:mainfrom
ctauchen:docs-seo-broken-backlink-redirects
Jul 3, 2026
Merged

Reclaim broken backlinks (part 2): 32 more 301 redirects#2821
ctauchen merged 2 commits into
tigera:mainfrom
ctauchen:docs-seo-broken-backlink-redirects

Conversation

@ctauchen

@ctauchen ctauchen commented Jul 3, 2026

Copy link
Copy Markdown
Collaborator

What

Follow-up to the first broken-backlink PR (which merged as 24 redirects). Adds 32 more 301 redirects to static/_redirects for docs.tigera.io/calico* (and one docs.tigera.io/calico-enterprise*) URLs surfaced by the full tigera.io subdomain backlink export that the first pass didn't cover. Each broken URL maps 1:1 to the most relevant live page, ordered by referring-domain rating.

Why

SEO audit request from Laura Ferguson (Corporate Marketing, 2026-07): "Reclaim high-authority broken backlinks with 301 redirects." The full subdomain export contains 653 docs.tigera.io backlink rows → 56 unique broken paths; 24 landed in the first PR, these are the remaining 32. (www.tigera.io rows are out of scope — already addressed per Laura.)

Verification

  • All unique destination URLs return 200 on the live site.
  • Sampled source paths confirmed 404 today.
  • No duplicate from paths, no shadowing wildcard; all rules well-formed (from to 301).
  • Rebased on current upstream/main (post first-PR merge); diff is exactly these 32 rules.

Judgment calls to review

Where a feature/page was removed and has no direct successor, the redirect points to the nearest relevant page or section landing (never the homepage):

  • security/ (bare) → /network-policy/
  • .../installation/hosted*, .../installation/, master/getting-started/docker/installation/manual/getting-started/ (kubeadm variant → self-managed-onprem/onpremises)
  • en/latest/*.html, en/1.4.0/datapath.html, master, master/introduction//about/ or /reference/architecture/data-path
  • both app-layer-policy variants → /network-policy/istio/app-layer-policy

Reviewers/product may want more precise destinations for these.

🤖 Generated with Claude Code

Follow-up to the initial broken-backlink PR. Adds 32 more 301 redirects for
docs.tigera.io/calico paths surfaced by the full tigera.io subdomain backlink
export that the first pass (24 redirects) didn't cover. Each broken URL maps
1:1 to the most relevant live page; where a feature was removed, it points to
the nearest relevant page or section landing (never the homepage). Ordered by
referring-domain rating.

SEO broken-backlink audit (Laura Ferguson, 2026-07).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Copilot AI review requested due to automatic review settings July 3, 2026 11:45
@ctauchen ctauchen requested a review from a team as a code owner July 3, 2026 11:45
@netlify

netlify Bot commented Jul 3, 2026

Copy link
Copy Markdown

Deploy Preview succeeded!

Built without sensitive environment variables

Name Link
🔨 Latest commit dc85ad9
🔍 Latest deploy log https://app.netlify.com/projects/tigera/deploys/6a47a21fdefcb10008106586
😎 Deploy Preview https://deploy-preview-2821--tigera.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
Lighthouse
Lighthouse
1 paths audited
Performance: 88 (🟢 up 19 from production)
Accessibility: 98 (no change from production)
Best Practices: 92 (no change from production)
SEO: 100 (no change from production)
PWA: -
View the detailed breakdown and full score reports

To edit notification comments on pull requests, go to your Netlify project configuration.

@netlify

netlify Bot commented Jul 3, 2026

Copy link
Copy Markdown

Deploy Preview for calico-docs-preview-next ready!

Name Link
🔨 Latest commit dc85ad9
🔍 Latest deploy log https://app.netlify.com/projects/calico-docs-preview-next/deploys/6a47a21f5330e20008fb6201
😎 Deploy Preview https://deploy-preview-2821--calico-docs-preview-next.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds additional Netlify redirect rules to recover broken inbound links to docs.tigera.io Calico (and one Calico Enterprise) pages, supporting the ongoing SEO backlink-reclamation effort.

Changes:

  • Add 32 new 301 redirect mappings in static/_redirects, grouped and annotated by referring domain rating (DR).
  • Redirect removed/renamed legacy paths (including master/ and older en/* HTML pages) to the closest current equivalents.

Comment thread static/_redirects Outdated
# DR 83
/calico/latest/security/kubernetes-nodes /calico/latest/network-policy/hosts/kubernetes-nodes 301
# DR 79
/calico/latest/en/latest/understanding.html /calico/latest/about/ 301

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Fixed in dc85ad9 — changed the destination to /calico/latest/about (no trailing slash) to match the file convention (lines 25, 27, 101, 113, 122).

Comment thread static/_redirects Outdated
/calico/latest/latest/getting-started/kubernetes/requirements /calico/latest/getting-started/kubernetes/requirements 301
/calico/latest/latest/getting-started/kubernetes/installation/hosted/kubeadm/ /calico/latest/getting-started/kubernetes/self-managed-onprem/onpremises 301
/calico/latest/latest/getting-started/kubernetes/installation/hosted/ /calico/latest/getting-started/ 301
/calico/latest/master/introduction/ /calico/latest/about/ 301

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Fixed in dc85ad9 — changed the destination to /calico/latest/about (no trailing slash) to match the file convention (lines 25, 27, 101, 113, 122).

Comment thread static/_redirects Outdated
/calico/latest/latest/getting-started/bare-metal/bare-metal /calico/latest/getting-started/bare-metal/ 301
/calico/latest/security/service-policy /calico/latest/network-policy/policy-rules/service-policy 301
/calico/latest/security/app-layer-policy /calico/latest/network-policy/istio/app-layer-policy 301
/calico/latest/master /calico/latest/about/ 301

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Fixed in dc85ad9 — changed the destination to /calico/latest/about (no trailing slash) to match the file convention (lines 25, 27, 101, 113, 122).

Match the file's established convention for the Calico About landing page
destination, avoiding inconsistent canonicalization. Per Copilot review.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@ctauchen ctauchen merged commit d01f9fb into tigera:main Jul 3, 2026
10 of 11 checks passed
@ctauchen ctauchen deleted the docs-seo-broken-backlink-redirects branch July 3, 2026 12:11
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants